BeMAME
version 0.29b0
By Casey Fleser (cfleser@kagi.com)
with ideas/contributions by many others.

Thanks to
Nicola Salmoria (MC6489@mclink.it) and Mirko Buffoni for the PC version.
Brad Oliver (bradman@primenet.com)  for the Mac version from which I "borrowed" many ideas, including the format of this readme :)
Rainer Riedl (rainer.riedl@stud.fh-regensburg.de) for the nice ROM selector dialog.
Steve Klingsporn (moofie@pobox.com) for the joystick code.
Susie Fleser for saying "That's great sweetheart" when I show her whatever it is I might be working on.
Alexandria Fleser for being Alexandria.
David Mitchell for his help in pointing out some of the problems in .27d0
John Watte, Chris Herborth, and all of the others on BeDevTalk for answering questions I might have before I've even thought to ask them.
Everyone who pestered me over the Halloween weekend, you know who you are, about version 0.29 forcing me to change my plans from a nice peaceful Riven filled weekend to one filled with much gnashing of teeth over things like BWindowScreens, mouse co-ordinates, and stoopid readme files. :)
Metrowerks bringing the Message Window to the foreground at the best times. :) Little joke fellows, thanks for not forcing me to write a makefile... yet.
And all the boys and girls of Be Inc. for bringing us such a fine OS.

The latest version of BeMAME can be found at http://www.glw.com/casey/bemame.html

BeMAME is free! That's right free! If you feel compelled to express your gratitude for this fine peice of software you could do any of the following:

Donate $10 to charity (good one Brad)
Send me a postcard (another good one Brad)
Send me $10 (a really good one Brad!)
Pay off my mortgage (ok this one is mine)

Casey Fleser
89 Vincent Lane
La Vergne, TN 37086

For a complete list of acknowledgements, please check the file 'readme.txt' that comes with this archive -- it contains the instructions, thank-you's and info for the current PC MAME release.

In a nutshell, MAME attempts to emulate as closely as possible the original hardware of the early eighties arcade games. As we discover how a game works, support for it is added to the emulator. This is happening at a rapid pace, so be sure to check back often for the latest release of MAME. 

The source code is freely distributed so if you see any bugs or areas of improvement in these modules, please let me know! Who knows you too might one day see your name in a read me file! 

Here's a quick breakdown of the default keys:

3			Insert a Quarter
1 & 2 			1 and 2 player start
P			Pause
Tab			Enter dip switch, keys and joy settings, and credits display menu. Pressing TAB
			again will back you to the emulator, ESC exit from MAME.
F3			reset the emulated machine
F4			Show the game graphics. Use cursor keys to change set/color, F4 to exit.
F8			Change frame skip on the fly (60, 30, 20, or 15)
F9			To change volume percentage thru 100,75,50,25,0 values
F10			Toggle speed throttling
F11			Toggle speed display
numpad +/- 	Volume adjust
ESC			Exit emulator

Command line usage:
BeMAME [name of the game to run] [options]

for example

BeMAME mspacman -full    will run Ms Pac Man in full screen mode

-full			Run BeMAME in full screen mode
-XxY			where X and Y are width and height (ex: '-800x600'). See below for valid
			combinations.
-640			Switch resolution to 640x480 (Full screen mode only)
-800			Switch resolution to 800x600 (Full screen mode only)
-1024			Switch resolution to 1024x768 (Full screen mode only)
-1280			Switch resolution to 1280x1024 (Full screen mode only)
-1600			Switch resolution to 1600x1200 (Full screen mode only)
-flipx			Flip display horizontally
-flipy			Flip display vertically
-ror 			rotate the display clockwise by 90 degrees. (Real soon now)
-rol			rotate display anticlockwise. (Real soon now)
-nojoy		don't poll joystick
-nomouse		don't poll mouse/trackball
-log			create a log of illegal memory accesses in ERROR.LOG (this can get VERY big)
-help, -?		display current mame version and copyright notice
-list			display a list of currently supported games
-listfull		display a list of game directory names + description
-listroms		display selected game required roms
-listsamples		display selected game required samples
-frameskip n	skip frames to speed up the emulation. For example, if the game normally runs at 60
			fps, "-frameskip 1" will make it run at 30 fps, and "-frameskip 2" at 20 fps. Use F11 to
			check the speed your computer is actually reaching. If the game is too slow,
			increase the frameskip value. Note that this setting can also affect audio quality
			(some games sound better, others sound worse).  Maximum value for frameskip is 3.
-cheat 		Cheats like the speedup in Pac Man or the level skip in many other games are 
			disabled by default. Use this switch to turn them on.

Folders needed to run BeMAME correctly, a brief description of each:
(These folders must reside in the same folder as the BeMAME program)

* ROMS - ROM images belong in a folder within this folder. The name of the folder can be found in the readme.txt file which can be found in the Docs folder. Please note that the Mac ROM files do not work with BeMAME. Use the PC files.
* Samples - Sampled sounds work just like ROM images, except they belong in this folder.
* Highscores - High score files (.hi) are stored in this folder.
* Settings - Game setting files (.cfg) are stored in this folder. If a game is no longer working correctly, try deleting it's .cfg file in this folder.

Known bugs / Missing features:
* No 2x2 pixels
* Full screen mode may not quit nicely (Deskbar death)
* Need to optimize.

Version History

0.29b0 November 2, 1997

What hasn't changed in this version. We sort of leap-frogged over the 0.28 version, straight on to 0.29. Since version 0.27 was put together just to see if I could get it to run, I decided to re-write BeMAME from the ground up. Very little was salvaged from 0.27. This version requires far fewer modifications to the MAME source code. Anyway here's what's new in a nutshell:
• Sources brought in line with MAME 0.29
• Added trackball support (still a bit shaky)
• Added joystick support for BeBoxen (Thanks Steve)
• Added full screen support.
• Command line fans rejoice.

0.27b0 October 9, 1997

Though this is the first "official" beta release of BeMAME, it is still very much a work in progress. Here's what's new:
• Fixed a problem with the ROM_RELOAD macro. This turned out to be a very complicated problem of not having any code written! Thanks to David Mitchell for pointing this one out.
• Added vector graphics routines that also weren't there. Doh! Thanks again Mr. Mitchell. I'll be looking into the LineArray stuff next release I promise :)
• Added POKEY support.
• Added high score, and settings files.
• Added support for sampled sounds.
• Added a pretty about box.

0.27d0 September 30, 1997

The 'd' stands for development release, and it shows. There are lots of things that are still unsupported in this release. Such as saveing high score and configuration files, and playing sound samples. I still need to do a lot of performance tweaks, and catch up with the rest of the MAME world which is at version 0.28.
